home *** CD-ROM | disk | FTP | other *** search
/ LOGIC 2000 February / LogicCd--feb.2000-mac-cdr.iso / Apple II / STRIPPER.FOLDER / UU.DOX < prev   
Text File  |  1990-04-02  |  7KB  |  145 lines
  1. UUencode/decode  v 1.1  by Andy Tefft 1/91
  2.  
  3. This program is freeware. Distribute all you want, but don't
  4. modify. If you find it useful, feel free to send me money --
  5. this might even encourage further development.
  6.  
  7. UU is a SYS file which should run on any // which runs ProDOS. It
  8. doesn't use extended memory or any enhanced ROM calls, and is
  9. designed for 40 column use.  Only one disk drive is required,
  10. although it will not allow disk swaps, so both the input and
  11. output files must be online at the same time (/ram can be used).
  12.  
  13. Main Menu commands:
  14.  
  15. P)refix change: This allows you to select the prefix used for
  16.   file access. Entering / allows you to select the volume name
  17.   of the last accessed device, regardless of its name. You can
  18.   enter any valid prefix, whether a full path name (starting with
  19.   a / and a volume name), or a partial path name (which is appended
  20.   to the current prefix).
  21.  
  22. M)ode (permission) change (encode): This allows you to query or change
  23.   the Unix-style permission mask (not used by the Apple). Default
  24.   is 644 and will usually not be changed. Hit RETURN when asked
  25.   to leave this value unchanged. The value you set will be used
  26.   until you change it or restart the program. You can enter up
  27.   to 4 characters; there is no validity check on the entered value;
  28.   anything longer than 4 characters will be truncated to 4.
  29.  
  30. T)ype & auxtype change (decode): This allows you to query or
  31.   change the filetype and auxtype of the file that will be created
  32.   when you decode a file. Defaults are BIN and $0000. You must enter
  33.   the type and auxtype as a hex value, without a $, with or without
  34.   leading 0's (max. length = 2 for type, 4 for auxtype). Hit
  35.   RETURN when asked to leave either value unchanged. There is no
  36.   validity check for these values, but they are displayed on the main
  37.   menu so you can check them for yourself. Again, values you enter
  38.   here will remain until you change them or restart the program.
  39.  
  40. L)inefeed after CR: This option is used only when encoding files.
  41.   If it is "yes", line terminators in the output file will be
  42.   the cr/lf combination; if it is "no" just a cr will be used.
  43.   sometimes cr/lf is referred to is "unix newline" mode. You
  44.   will only need to use this option if you are uploading to
  45.   a system which uses cr/lf terminators using xmodem or other
  46.   binary protocol (kermit in text mode will convert apple newlines
  47.   to cr/lf if needed).
  48.  
  49.   Either cr or cr/lf line terminators should be decoded properly.
  50.   Other strange line terminators (lf/cr for example) may or may
  51.   not work.
  52.  
  53. G)rave to replace blanks: By default, when encoding a file
  54.   any blanks in the encoded data are replaced by the grave
  55.   accent (`). This is to prevent loss of trailing blanks,
  56.   etc. This option turns on or off this replacement.
  57.  
  58.   Most uudecode programs should not have any problems with
  59.   the grave accents. Additionally, most will pad the ends of
  60.   lines that have been truncated with spaces while decoding. This
  61.   uudecode does both.
  62.  
  63. C)atalog: Displays a brief catalog listing. You will be prompted
  64.   for the directory to catalog. Hitting RETURN catalogs the prefix
  65.   directory. Entering control-c (or terminating your entry in
  66.   control-c) and return cancels the cataloging.
  67.  
  68.   The catalog display lists the filenames, filetypes, file lengths
  69.   in blocks and bytes (decimal displays) and auxtypes in hex. It
  70.   pauses after every twenty entries displayed. Hitting control-c
  71.   will abort the display.
  72.  
  73.   The full pathname of the directory being cataloged is listed
  74.   at the beginning of the display. The numbers of blocks used and
  75.   free on the device are shown after the display.
  76.  
  77.   There should be no problems with directories of any size,
  78.   since only one block of the directory is read at a time.
  79.  
  80. E)ncode a file: This allows you to uuencode a file. You will be
  81.   asked for input and output paths. Hit RETURN in answer to either
  82.   question and you can return to the menu (you will be asked if you
  83.   want to; entering "N" will let you enter the filename again).
  84.  
  85.   You can enter either a full or partial pathname for either file
  86.   (if you don't enter a starting /, prodos will prepend the current
  87.   prefix to what you type in). The name you enter for the input
  88.   file will be put into the begin line of the encoded file, so if
  89.   your input and output files will be on different volumes (both
  90.   must be online) or different directories on the same volume, you
  91.   will probably want to first set the prefix to the INPUT  file's
  92.   prefix, and enter the full pathname for the output file. For example:
  93.  
  94.   input file is /disk1/file, you want output to go to /disk2/file.uu.
  95.   first set prefix to /disk1/ (trailing slash optional); enter
  96.   "file" as input file, "/disk2/file.uu" as output file. UUedecode
  97.   will then call the output file "file" when you or someone else
  98.   decodes it.
  99.  
  100.   If the output file exists already, you will be given the option
  101.   to delete it or not. If you say "no", you will be able to enter
  102.   a new output name; at this point you can return to the menu by
  103.   just hitting RETURN.
  104.  
  105. D)ecode a file: This will allow you to uudecode a file that
  106.   has been uuencoded. It will ask for the input file name;
  107.   it will then search through the input file for the "begin"
  108.   line which contains the output file name. You will be given
  109.   the option to change or use this name only if there is an error
  110.   with it. Judicious use of the prefix and full pathnames
  111.   may be needed to use more than one volume for decoding
  112.   (remember, both volumes must be online at the same time).
  113.  
  114.   The only error checking done is to check for the presence of
  115.   an 'end' line. If one does not exist, you will be warned but
  116.   the output file will remain anyway.
  117.  
  118. Q)uit: allows you to quit. It asks first for verification and then
  119.   either returns to the menu or does a prodos quit.
  120.  
  121. Upcoming features:
  122.  
  123. I may include some support to repair some of the damage done by
  124. some networks to some characters.
  125.  
  126. I forgot to put in an option to unlock and delete a locked file.
  127. I'll see when I can get to that.
  128.  
  129. I am working on a file selection dialog, but that will limit pathnames
  130. to 64 characters in length.
  131.  
  132. That's about all I can think of for now besides allowing entering
  133. the 3-letter filetypes (which I don't plan on doing) instead of
  134. hex numbers. Come to think of it, that might not be too much work.
  135.  
  136. Thanks to Albert Chin (acmfiu@fiu.edu) for the info regarding
  137. the MLI calls.
  138.  
  139. Andy Tefft
  140. 99 E. Main St.
  141. North East, PA 16428-1334
  142. (814) 725-1344
  143.  
  144. (till May 12, '91: art100@psuvm.psu.edu)
  145.